home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / relnotes / eoe / chA.z / chA
Text File  |  1998-11-02  |  16KB  |  331 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        1.  _C_H_A_L_L_E_N_G_E_/_O_n_y_x__I_O_4__P_R_O_M
  9.  
  10.        This chapter contains information about the CHALLENGE/Onyx
  11.        IO4 PROM (Programmable Read-Only Memory) Monitor.  While in
  12.        most cases the CHALLENGE/Onyx PROM is similar to the PROMs
  13.        discussed in the user's manuals, it contains a new graphical
  14.        user interface and contains a number of new hardware
  15.        configuration features. And while most of these same
  16.        operations may be applied on other SGI systems, notably the
  17.        Indy and Indigo2, please refer to the _p_r_o_m(1M) manual page
  18.        for a complete description of all of the common commands and
  19.        environment variables.
  20.  
  21.        1.1  _T_h_e__P_R_O_M__G_r_a_p_h_i_c_a_l__U_s_e_r__I_n_t_e_r_f_a_c_e
  22.  
  23.        In an attempt to improve the look and feel of the PROM user
  24.        interface, the IO4 PROM presents you with a graphical
  25.        interface on Onyx systems when the _c_o_n_s_o_l_e environment
  26.        variable is set to ``g''.  In all cases you can use the
  27.        keyboard instead of the mouse, and in most cases the
  28.        keystrokes required to perform a particular task are
  29.        identical.
  30.  
  31.        For example, the main five-item panel displayed when the
  32.        system first starts up is identical to the five-item menu
  33.        found on previous systems.  To make a selection, you either
  34.        click any mouse button on one of the five buttons on the
  35.        left, or you press the corresponding number key.  The top
  36.        item (``Start System'') is option number 1, and the last
  37.        item (``Enter Command Monitor'') is option number 5.
  38.  
  39.        1.2  _C_H_A_L_L_E_N_G_E_/_O_n_y_x__H_a_r_d_w_a_r_e__C_o_n_f_i_g_u_r_a_t_i_o_n__C_o_m_m_a_n_d_s
  40.  
  41.        The IO4 PROM provides a number of commands that you to
  42.        examine and modify the hardware configuration of your
  43.        system.
  44.  
  45.        1.2.1  _C_h_e_c_k_i_n_g__a_n_d__U_p_d_a_t_i_n_g__t_h_e__H_a_r_d_w_a_r_e__I_n_v_e_n_t_o_r_y  When
  46.        the system first starts up, the IO4 PROM automatically
  47.        examines all of the boards in the system to determine
  48.        whether any components have failed.  During this process,
  49.        the IO4 PROM reads a copy of the hardware inventory out of
  50.        nonvolatile memory and compares the system's current
  51.        configuration with the last known inventory.  If it finds a
  52.        discrepancy, the PROM prints a warning message.  When errors
  53.        are found, the PROM automatically pauses before continuing
  54.        so that the administrator has a chance to examine the error
  55.        notices.  The following example shows the output of the
  56.        inventory checker if it notices that one of the processors
  57.        on an IP19 is missing.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.        CCCChhhheeeecccckkkkiiiinnnngggg iiiinnnnvvvveeeennnnttttoooorrrryyyy............
  75.        ************     SSSSlllliiiicccceeee 1111 oooonnnn tttthhhheeee IIIIPPPP11119999 iiiinnnn ssssllllooootttt 2222 iiiissssnnnn''''tttt vvvviiiissssiiiibbbblllleeee
  76.        PPPPrrrreeeessssssss <<<<EEEENNNNTTTTEEEERRRR>>>> ttttoooo ccccoooonnnnttttiiiinnnnuuuueeee
  77.  
  78.        If system uptime is critical (if, for example, your system
  79.        is a central server) and operators aren't available around
  80.        the clock, you might not want the PROM to wait for operator
  81.        intervention when the hardware inventory checker notices a
  82.        problem.  To force the system to continue booting in the
  83.        face of non-fatal failures, set the _n_o_n_s_t_o_p environment
  84.        variable to ``1'' (see Section A.3, ``Environment
  85.        Variables'').
  86.  
  87.        The hardware inventory routines are incapable of
  88.        differentiating between hardware that has been physically
  89.        removed from a system and hardware that is so broken that it
  90.        doesn't appear to be present.  For this reason, if you
  91.        change the configuration of your CHALLENGE/Onyx system, you
  92.        must explicitly update the system's hardware inventory.  To
  93.        do this, first enter the PROM monitor by selecting the
  94.        ``Enter Command Monitor'' option from the PROM menu.  When
  95.        the command monitor displays its prompt (``>>''), type
  96.        update, then press the <Enter> key.  This tells the PROM
  97.        that the system's current configuration is correct and
  98.        prevents it from complaining in the future.  Next, type
  99.        reset and press the <Enter> key to reset your system.
  100.  
  101.        If you see error messages when no hardware modifications
  102.        have occurred, a component in your system might have failed.
  103.        Call your service provider.  In this situation, the hardware
  104.        inventory information might provide valuable insight into
  105.        the nature of the problem.  For this reason, do not update
  106.        the hardware inventory until a field service engineer first
  107.        examines the system.
  108.  
  109.        1.2.2  _D_i_s_p_l_a_y_i_n_g__C_u_r_r_e_n_t__H_a_r_d_w_a_r_e__C_o_n_f_i_g_u_r_a_t_i_o_n  To display
  110.        a list of boards installed in a CHALLENGE or Onyx system,
  111.        using the command monitor (with prompt ">>"), type hinv -b.
  112.        The ----bbbb option forces _h_i_n_v to display bus-specific
  113.        information.  The ----vvvv switch, when used with the ----bbbb switch,
  114.        causes _h_i_n_v to display more detailed information about
  115.        boards.  For example, typing:
  116.  
  117.        hhhhiiiinnnnvvvv ----bbbb ----vvvv
  118.  
  119.        displays the configuration of all the processors, memory
  120.        banks, and IO adapters in the system.
  121.  
  122.        1.2.3  _P_O_D__M_o_d_e  In the unlikely event of an extreme
  123.        hardware failure, the system might drop into a low-level
  124.        diagnostic environment known as POD (Power-On Diagnostics)
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.        mode.  POD mode helps in system diagnosis and is not
  141.        intended for use by customers.  Entering POD mode is usually
  142.        a sign of severe hardware problems; consult a service
  143.        provider.
  144.  
  145.        1.3  _E_n_v_i_r_o_n_m_e_n_t__V_a_r_i_a_b_l_e_s
  146.  
  147.        This section describes special procedures to customize
  148.        certain aspects of the PROM Monitor.  Many aspects of the
  149.        system startup process can be customized by changing PROM
  150.        environment variables.  Some of these PROM environment
  151.        variables are stored in nonvolatile memory, which retains
  152.        its value after the system is powered off.  Some common
  153.        customizations are described in the sections below.  More
  154.        information is provided in the _p_r_o_m(1M) manual page.
  155.  
  156.        Environment variables can be changed with the _s_e_t_e_n_v command
  157.        in the PROM Command Monitor.  To get to the PROM Command
  158.        Monitor, first choose ``Stop for System Maintenance'' when
  159.        the system is starting in order to get to the System
  160.        Maintenance Menu, then choose ``Enter Command Monitor'' by
  161.        either clicking on it with the mouse or pressing 5.
  162.  
  163.        1.3.1  _S_e_l_e_c_t_i_n_g__t_h_e__C_o_n_s_o_l_e__D_e_v_i_c_e  Servers and
  164.        workstations can be configured to use a terminal connected
  165.        to serial port #1 as their console.  If a system has a
  166.        graphics board, the PROM Monitor uses it as the console if
  167.        the _c_o_n_s_o_l_e environment variable is set to ``g''; if
  168.        graphics aren't installed or the _c_o_n_s_o_l_e variable is set to
  169.        ``d'', the system uses the serial port as the system
  170.        console.
  171.  
  172.        To force the console to be the serial port, set the _c_o_n_s_o_l_e
  173.        variable to ``d'' using the _s_e_t_e_n_v command:
  174.  
  175.        sssseeeetttteeeennnnvvvv ccccoooonnnnssssoooolllleeee dddd
  176.  
  177.        To change the console back to the graphics screen, set the
  178.        _c_o_n_s_o_l_e variable to ``g'':
  179.  
  180.        sssseeeetttteeeennnnvvvv ccccoooonnnnssssoooolllleeee gggg
  181.  
  182.        Typing init reinitializes the system and forces it to switch
  183.        to the selected console device.
  184.  
  185.        1.3.2  _B_o_o_t_i_n_g__F_r_o_m__a_n__A_l_t_e_r_n_a_t_e__D_i_s_k  There are three
  186.        environment variables in the PROM for specifying the device
  187.        to boot from.  The _S_y_s_t_e_m_P_a_r_t_i_t_i_o_n variable specifies the
  188.        location of the device volume header.  Its default value is
  189.        ``dksc(0,1,8),'' which specifies SCSI controller 0, disk 1,
  190.        partition 8.  The _O_S_L_o_a_d_P_a_r_t_i_t_i_o_n variable specifies the
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.        device from which the IRIX kernel should be loaded.  The
  207.        default value for the _O_S_L_o_a_d_P_a_r_t_i_t_i_o_n variable is
  208.        ``dksc(0,1,0),'' which tells the PROM to look for the kernel
  209.        in partition 0 on disk 1 of SCSI controller 0.  By
  210.        convention, the volume header is always partition 8 on a
  211.        disk, and the kernel is always located in partition 0.
  212.  
  213.        The _r_o_o_t variable is the third variable that needs to be
  214.        changed when selecting a different boot device.  The _r_o_o_t
  215.        variable tells IRIX the name of the device that holds the
  216.        root filesystem.  Because it is used by IRIX rather than the
  217.        PROM, its format is different from that of the
  218.        _O_S_L_o_a_d_P_a_r_t_i_t_i_o_n and _S_y_s_t_e_m_P_a_r_t_i_t_i_o_n variables.  The default
  219.        value of _r_o_o_t is ``dks0d1s0,'' which specifies that the root
  220.        filesystem is stored on partition 0 of disk 1 on SCSI
  221.        controller 0.
  222.  
  223.        To boot from disk number two on controller 0, type:
  224.  
  225.        sssseeeetttteeeennnnvvvv SSSSyyyysssstttteeeemmmmPPPPaaaarrrrttttiiiittttiiiioooonnnn ddddkkkksssscccc((((0000,,,,2222,,,,8888))))
  226.        sssseeeetttteeeennnnvvvv OOOOSSSSLLLLooooaaaaddddPPPPaaaarrrrttttiiiittttiiiioooonnnn ddddkkkksssscccc((((0000,,,,2222,,,,0000))))
  227.        sssseeeetttteeeennnnvvvv rrrrooooooootttt ddddkkkkssss0000dddd2222ssss0000
  228.  
  229.        To boot from disk number one on controller 1, type:
  230.  
  231.        sssseeeetttteeeennnnvvvv SSSSyyyysssstttteeeemmmmPPPPaaaarrrrttttiiiittttiiiioooonnnn ddddkkkksssscccc((((1111,,,,1111,,,,8888))))
  232.        sssseeeetttteeeennnnvvvv OOOOSSSSLLLLooooaaaaddddPPPPaaaarrrrttttiiiittttiiiioooonnnn ddddkkkksssscccc((((1111,,,,1111,,,,0000))))
  233.        sssseeeetttteeeennnnvvvv rrrrooooooootttt ddddkkkkssss1111dddd1111ssss0000
  234.  
  235.        Finally, to boot from disk number 3 on controller 2, type:
  236.  
  237.        sssseeeetttteeeennnnvvvv SSSSyyyysssstttteeeemmmmPPPPaaaarrrrttttiiiittttiiiioooonnnn ddddkkkksssscccc((((2222,,,,3333,,,,8888))))
  238.        sssseeeetttteeeennnnvvvv OOOOSSSSLLLLooooaaaaddddPPPPaaaarrrrttttiiiittttiiiioooonnnn ddddkkkksssscccc((((2222,,,,3333,,,,0000))))
  239.        sssseeeetttteeeennnnvvvv rrrrooooooootttt ddddkkkkssss2222dddd3333ssss0000
  240.  
  241.  
  242.        1.3.3  _S_t_a_r_t_i_n_g__t_h_e__S_y_s_t_e_m__A_u_t_o_m_a_t_i_c_a_l_l_y  By default, the
  243.        PROM starts the operating system after waiting a brief
  244.        period of time each time the system is powered on.  If you
  245.        do not click on the ``Stop for System Maintenance'' button,
  246.        or press the <Esc> key, the system attempts to start the
  247.        operating system by loading it into memory and executing it.
  248.        The environment variable _a_u_t_o_l_o_a_d can be set to ``yes'' to
  249.        enable this feature, or to ``no'' (the default) to inhibit
  250.        it.  If automatic startup is disabled, the PROM displays the
  251.        System Maintenance Menu after running power-on diagnostics.
  252.  
  253.        1.3.4  _B_o_o_t_i_n_g__W_i_t_h__N_o_n_-_T_e_r_m_i_n_a_l__H_a_r_d_w_a_r_e__F_a_i_l_u_r_e_s  By
  254.        default, the PROM stops and prints a warning message if it
  255.        discovers that a component has failed in some manner.  In
  256.        many cases, however, the failure of a single processor or
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                   - 5 -
  269.  
  270.  
  271.  
  272.        bank of memory isn't enough to keep the system from coming
  273.        up.  If your CHALLENGE/Onyx system is configured with eight
  274.        processors, losing one of them is non-fatal.  To prevent
  275.        such non-fatal hardware problems from stopping the system in
  276.        the PROM, you can set the _n_o_n_s_t_o_p variable to 1:
  277.  
  278.        sssseeeetttteeeennnnvvvv nnnnoooonnnnssssttttoooopppp 1111
  279.  
  280.        To ensure that the system displays a notification message in
  281.        the event of any hardware failures, set nonstop to 0:
  282.  
  283.        sssseeeetttteeeennnnvvvv nnnnoooonnnnssssttttoooopppp 0000
  284.  
  285.        1.3.5  _R_e_b_o_o_t_i_n_g__I_m_m_e_d_i_a_t_e_l_y__A_f_t_e_r__C_r_a_s_h_e_s  Normally, the
  286.        system will pause waiting for user intervention after a
  287.        system crash.  In environments which demand high
  288.        availability such a pause may be undesirable.  To force the
  289.        system to reboot immediately after a panic, set the _r_e_b_o_u_n_d
  290.        environment variable to ``y'' using the PROM's setenv
  291.        command:
  292.  
  293.        sssseeeetttteeeennnnvvvv rrrreeeebbbboooouuuunnnndddd yyyy
  294.  
  295.        To return to the default behavior of waiting for user
  296.        intervention, set _r_e_b_o_u_n_d to 'n'.
  297.  
  298.        1.3.6  _R_e_s_t_o_r_i_n_g__D_e_f_a_u_l_t_s  The PROM environment variables
  299.        can be reset to their factory defaults by issuing the
  300.        _r_e_s_e_t_e_n_v command from the PROM Command Monitor.  Because
  301.        _r_e_s_e_t_e_n_v also resets the _n_e_t_a_d_d_r environment variable, you
  302.        may wish to note the system's IP address before using this
  303.        command.
  304.  
  305.        1.4  _K_n_o_w_n__B_u_g_s
  306.  
  307.        The following list details all known IO4 PROM bugs at the
  308.        time of release.  Because the IO4 PROM is software-writable,
  309.        these bugs will be fixed by PROM updates in future releases
  310.        of the operating system.
  311.  
  312.        1.4.0.1  _T_h_e__G_U_I__h_a_n_d_l_e_s__u_n_e_x_p_e_c_t_e_d__w_a_r_n_i_n_g__m_e_s_s_a_g_e_s__p_o_o_r_l_y
  313.        If an unexpected warning or status message is printed, the
  314.        graphical user interface switches over to a text port to
  315.        display the message.  The PROM continues to execute, but
  316.        additional information is displayed textually rather than
  317.        graphically.  This bug is usually seen if an informational
  318.        message is displayed while the miniroot is being loaded
  319.        during the installation process.
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.